3D GFX/3D GFX.iso/pcutils/os2/jview/jview.hlp

OS/2 Help File | 1995-12-31 | 79.8 KB | 1,996 lines

ΓòÉΓòÉΓòÉ 1. JView Introduction ΓòÉΓòÉΓòÉ

JView is an image viewing system designed specifically for the OS/2 operating
system.  It handles are variety of image formats and is designed to work in an
8 bit or higher graphics system. Every effort has been made to provide help
on-line so that everything you need is a mouse click away.

One of the most unique aspects of JView is that it has been designed in a
modular fashion.  Functions and utilities can be added at any time, allowing
the end user to increase the power of JView without constantly having to
purchase upgrades.  An open standard for adding modules has been provided,
allowing anyone (even you) to write your own functions. So while the base
application just reads and write images, you can add a paint kit, scanner
interface, etc.

The price for the flexibility provided in choosing how to view images is added
complexity.  Viewing images has been implemented in ways that you may be
unfamiliar with.  It is probably worth your while to look through the section
on Viewing Strategies at this time.


ΓòÉΓòÉΓòÉ 2. PopUp Menu ΓòÉΓòÉΓòÉ

The main menu system is accessed by single clicking the right mouse button. You
probably figured this out by now. This help subsection is designed to mimic the
layout of the Popup menu.  Follow the subheadings just as they are presented in
the menu.


ΓòÉΓòÉΓòÉ 2.1. Miscellaneous ΓòÉΓòÉΓòÉ

This menu heading leads to several possible submenus.  Generally commands in
this group are used infrequently and/or deal more with presentation issues than
specific images.


ΓòÉΓòÉΓòÉ 2.1.1. Create JView.dth ΓòÉΓòÉΓòÉ

Create JView.dth file.  This file is needed to convert images so that they
effectively use the system colormap (your default palette).  The process will
take around a minute, depending on your system.  You may specify low or high
CPU usage and can abort the process at any time.  The file created is used in
conjunction with the JView.pal file.  To assure an accurate map of the system
colormap it is imperative that before you run this option that you shutdown
JView and ANY OTHER GRAPHICS PROGRAMS.  Next, delete the file JView.pal.  Now
you can startup JView and run this option.  You will only need to run this
option once or whenever you change graphics cards.  While the file creation is
running you may use your computer as you normally would, even for running
graphics applications.  You will probably experience sluggishness until the
process has finished unless you choose low CPU use.

On some systems the information about the system palette will not be available
if the graphics systems is currently in 15 bit or higher (65,000 colors) mode.
If you have your system setup to run 15 bit graphics (or higher) and run this
option as directed above, and get particularly bad results you may need to
first reset your system so that it displays a maximum of 256 colors.  Follow
the above procedure and after the process is complete you may reset your
graphics systems to any desired level.  You should understand that if you
usually run your system in 15 bit or higher graphics mode then there is no real
point in ever specifying that images be displayed with system colors.  The
possible exception to this is that you will need the JView.dth file if you are
deliberately trying to convert an image into the system palette.


ΓòÉΓòÉΓòÉ 2.1.2. Float ΓòÉΓòÉΓòÉ

An interesting little function.  It is on when there is a check mark by this
entry in the menu.  This causes the main (image) window to stay on top of all
other application windows. Thus, when you are typing at your word processor,
the JView window will stay on top of the application, but the application will
still be active, and thus getting keyboard and mouse inputs!  Well, some of us
here like it anyway.  Slight hit on the old CPU but it doesn't seem too bad.
You can use the F key to toggle it on or off.  Its especially nice to turn on
Float when running a slide show; just put JView in a corner just to keep things
interesting.


ΓòÉΓòÉΓòÉ 2.1.3. Image Information ΓòÉΓòÉΓòÉ

This command brings up a window that shows information about the currently
displayed image.  The information consists of:

o The Filename
o Format of the image file and filesize
o Resolution of the image in memory
o Resolution of the image as displayed
o Color information
o An box that occasionally will show warning messages, you can use the arrow
  keys if the information isn't all displayed
o A history list box of manipulations that have been performed on the current
  image.

The Information Box will remain around as long as JView is alive or until the
Hide button is pressed.

The information categories are pretty self explanatory, but for clarity
Resolution refers to the resolution of the image as it is currently stored in
memory, while Display Res. is the resolution that the image is currently being
displayed at.


ΓòÉΓòÉΓòÉ 2.1.4. Load Add On... & Load OS/2 Image ... ΓòÉΓòÉΓòÉ

These two menu commands may appear depending on which options your have set for
JView.  They are explained in Optimizing Performance.


ΓòÉΓòÉΓòÉ 2.1.5. Move Window ΓòÉΓòÉΓòÉ

This mimics the effects that result when the sytem menu command Move (Alt + F7)
is used.  The reason that it is duplicated here is that if you turn off the
Title Bar the system menu disappears and you would lose the ability to move the
window.


ΓòÉΓòÉΓòÉ 2.1.6. Refresh ΓòÉΓòÉΓòÉ

This simply causes the image window to be repainted.


ΓòÉΓòÉΓòÉ 2.1.7. Save Window Positions ΓòÉΓòÉΓòÉ

Save Window Positions will store the current window locations of JView. This
includes the File Open Dialog, the Information Dialog, and the main image
window.  These stored positions will be used at startup.


ΓòÉΓòÉΓòÉ 2.1.8. Toggle Title Bar ΓòÉΓòÉΓòÉ

Toggle Title Bar will turn on and off the main title bar.  Note that you can
NOT MINIMIZE JView when the Title Bar is off.


ΓòÉΓòÉΓòÉ 2.2. Files ΓòÉΓòÉΓòÉ

This menu command does nothing by itself except bring up a second pull down
menu which has commands generally relating to files.  Slide Show.  Open a file.
Save a file, etc.


ΓòÉΓòÉΓòÉ 2.2.1. Batch Conversion ΓòÉΓòÉΓòÉ

This feature allows you to convert a series of files from their current format
style to a new type.  The operation of the dialog is virtually identical to the
SlideShow Dialog so you should first familiarize yourself with its operation
before proceeding.

The differences between the operation of the SlideShow Dialog and the Batch
Conversion Dialog are found in the Options.  When Options is pushed, a new
dialog is presented and this is where all the significant information is
entered.


ΓòÉΓòÉΓòÉ 2.2.1.1. Batch Conversion Options ΓòÉΓòÉΓòÉ

The layout of this dialog is very similar to the File Save Dialog.  Since batch
conversions are a more advanced feature than saving a single file, it is
assumed that you are familiar with the methods involved in saving a single
file.

The options unique to batch conversions deal with what should be done with the
files in question.

Delete source file will cause the file that is being read from to be deleted if
the conversion is successful.  Obviously, this should not be used on critical
files.  It is safer to do your conversion, verify that the converted files were
converted correctly and then delete the original files.

Warn on overwrite and Overwrite target are mutually exclusive options.  With
Warn on overwrite selected, if a file exists with the same name as a file that
you are trying to create with the conversion, you will be prompted about wether
to overwrite the file.  This will prevent you from inadvertently losing a file.
Selecting Overwrite means that you know what you are doing and any file that
already exists will be overwritten without protest.


ΓòÉΓòÉΓòÉ 2.2.2. Open File Dialog ΓòÉΓòÉΓòÉ

This dialog is one of the more useful features of JView.  The dialog runs
independently of the main window.  You can select a new file at any time unless
JView prevents it, and generally you will only be prevented from opening a file
if JView is already trying to open a file.

File Mask  In the Options Notebook you can decide what you would like the
default setting for this to be.  You can change the value in this entry field
at any time but the change will only be effective while the current JView
session is active.  Typically you would just enter *.* or *.bmp here.  You can
also use *.bmp;*.gif to select multiple file extensions.  If you want you could
also type in the name of a file or the full name ala c:\file\my.bmp.  Further,
you can change to a new directory fairly quickly by using c:\files\go_here\*.*
- This would change to the approprate drive and directory and also set the File
Mask to *.*. Remember to hit the Open button after you make your changes in
order for them to take effect.

General Idea  Consider this information for the GUI impaired.  A file can be
selected by typing the file name into the File Mask entry field or by double
clicking on the appropriate file in the Files list box.  Directories are
changed by double clicking in the directory listbox, using the Quick Dir or by
using the H Dir (a feature discussed below).  Drives are changed using the pull
down listbox. The file mask entry field is where, in addition to simply typing
a file name, you may enter wild cards, like *.gif or multiple wild cards
separated by a ; or , for example *.gi*;*.bmp;*.tga (no spaces - the space bar
can optionally be set as a hot key to minimize JView!)  A list of only those
files that match the mask will be shown in the files list box.  Files can be
shown in either alphabetical or dated format by selecting the appropriate
button.

Confirm on delete does what it says.  If you try and delete a file, it will
prompt you first.  Turn it off and delete will just kill the file when you hit
the Delete button.  BEWARE!!! The file deleted is the file shown in the current
file area (at the upper left side of the dialog) not necessarily the file
currently being viewed.  If you only single click on a file in the files list
box it will be selected as the current file even though you have not yet loaded
it. Why does this feature exist?  Often a series of images are less than
desirable, so the ability to cream'em all at once is useful.  Just leave the
Confirm on Delete attribute on if your not sure, you will always be prompted.

Browse Mode keeps the dialog open when not in use.  This is useful if you are
going to look at a variety of files and don't want to keep opening the dialog
each time.  When Browse Mode is active, hitting Cancel has features discussed
below. When Browse Mode is off hitting Cancel will close the Open File dialog.
Most often it will be faster just to minimize the Open File Dialog if you want
it out of the way.

Cancel  When Browse Mode is not checked this will just dismiss the Open File
Dialog.  When Browse Mode is active, Cancel will have two possible effects.  If
an image is currently being loaded, Cancel will stop the file read and load the
default JView image.  If an image is not being loaded, Cancel will cause the
main window to rise to the top (become active).

H File is an historical listing of all directories you have visited in the
current JView session.  If you have gone to several directories and will go
back to them, use this listbox and save yourself some keystrokes (or mouse
clicks).

Low Priority Open will cause the selected file to be read in at low priority,
giving other processes more of the CPU.  This option gets applied even while a
file is currently being read.  Thus, you can change the priority of a file read
by toggling this switch. See the discussion about Low Priority Threads.

Preview Mode will use the fastest method possible to read a file.  The image
will always be converted to grayscale and for certain file formats the image
may be a scaled down version of the full file.

There are two buttons on the lower left side of the dialog box labeled N and P.
These buttons will cause the file either next or previous relative to the
currently highlighted file to be opened.  Both will cycle to either the
beginning or end of the list when going off the end.  They have accelerator
keys associated with them.

JView will attempt to read files that other applications are currently writing.
For most file types, JView can handle truncated images and so there will not be
a problem.  Generally speaking a certain minimum (header info) is needed.
Usually there will not be a problem, but you never know.

To the right of all the obvious buttons and to the left of the icon, there is
the I button.  This stands for information.  After you have highlighted a file
in the files listbox, you can hit the I button to find out the file format, and
the resolution of the image.  This way you can test an unknown file before
loading to see if it has some rediculous resolution, like 10000 by 10000 which
would claim 100 megs of memory if you tried to load it.  If you have previously
Iconified the file, the icon will be displayed by hiding the directory listbox.
Dry your little eyes, the directory listbox is just hiding and will come back
to visit you after you click on any file in the file listbox, except the
currently selected one.  A potential problem exists if you only have one file
in the directory and you view the icon.  The icon will display, but you won't
be able to change directories because the directory listbox will be hidden, but
you won't be able to unhide it because you won't be able to click on a new file
in the file listbox.  Whew, thats confusing!  You can get around this by
switching drives,  or using your QuickDir.

One last item is the Quick Dir listbox.  Go back on click on Quick Dir for the
description.


ΓòÉΓòÉΓòÉ 2.2.3. Printing ΓòÉΓòÉΓòÉ

The quality of the prints you create will be function of trial and error at
first. On black and white printers you may wish to convert the image to black
and white or gray before using some of the more advanced tools available.
Experiment at first so that you gain a feel for how best to manipulate your
images for optimum printing.

Printing is fully multi-threaded so that you may immediately begin another task
after initiating a print job - even loading in a new image.

The challenging part about printing is to do so without distorting your image
inadvertently.  This is why there is a readout on the top of the print utility
showing how much the image will distort if it is printed as currently
configured.  In this context distortion means the aspect ratio is not unity.
Usually you will want to make the distortion zero (an aspect ratio of 1), but
that's up to you.

The Distortion of apect ratio tells you how much your image is being squished
because of the margins you have called for.  Basically, 0 means that your image
will print true, while positive values indicate the sides are squished in, a
negative value means the top is squished down.

You select a printer by clicking on the appropriate printer name shown in the
Printers listbox.  Double clicking on the printer will allow you to edit its
defaults.  You have the option of specifying a default printer (see Options).
If none has been selected, the system default printer will initially be
selected.  If you modify the settings or change printers, those changes will
remain in force for the entire session, but are discarded after the JView is
closed.

You have the ability to specify four distances, the left and top margins and
the width and height of the image.  Additionally, you may modify the colors
that will be used for printing.  If you choose black and white, a Floyd
Steinberg black and white dither is applied.  If you choose to go from 24 bit
to 8 bit color, the method for conversion will depend upon that which has been
chosen under the general options configuration for doing 24 to 8 bit
quantization.


ΓòÉΓòÉΓòÉ 2.2.4. Saving an Image ΓòÉΓòÉΓòÉ

The File Save dialog is pretty simple but deserves some explanation.  The Quick
Dir listbox needs some detailed explanation that can be accessed by clicking on
Quick Dir.  Drive, directory, and files are listings or displays of what is
currently available.  You can enter any valid directory/path combo in the Save
as: entry box.  The file listing is for information purposes mostly, but if you
do click on the file it will become the entry in the Save as: box.

When you select a file type, that appropriate extension is added to or changed
for the text in the Save as: entry field.

File types available are:

o GIF
o JPEG
o OS2 BMP (RLE & uncompressed)
o Windoze BMP (RLE & uncompressed)
o PBM (raw and ASCII)
o X11 BMP
o Sun Raster
o TARGA (RLE & uncompressed)
o TIFF
o PCX

All are pretty self explanatory, but it should be noted that for Windows and
OS2 bitmaps both regular and RLE formats are written.  RLE formats will do
little good on real life images with more than 16 colors.  In addition to these
built-in formats, you have the option of tying into the file formats that come
with Warp's BonusPak.  See Additional File Formats for details.

There are three options located at the bottom of the dialog.  Save at displayed
size will write the image at whatever resolution the image is currently being
displayed with.  This is contrasted with the resolution that the image is
stored in memory as.  See Viewing Strategies  for details.

The second option is to Save at Low Priority.  Since JView is multithreaded you
can save a file and while it is being written to disk, you can go ahead
(yippy!) and start load a different image.  Low priority will write the current
file a little slower (in theory anyway) so that you (or other processes) can
use the CPU to do more important things, like loading/looking at another image.
(See the discussion about Low Priority Threads).  Only one image can be saved
at a time.  The menu command to save an image will be inaccessible until JView
has finished saving the current file.  During the time an image is being saved
the border of JView will turn red or blue depending on whether JView is the
active application.  When the save is complete, JView will return to its
default border colors.  In this way you will know when a file save is complete.
If you try and exit JView before a save is finished, you will get a warning
message and the option of finishing the save before termination.

The third option is Iconify which will create an icon version of the image and
make it the icon for the file.  This way you get an image that is just big
enough for you to get an idea of what the file is like.  See the iconify
description for important details.  When iconify is selected here, you do not
get to use a cropping rectangle to indicate what area of the image becomes the
icon, the whole image is used.

Colors  The colors option will cause the image to be saved in the appropriate
number of indicated colors.  The saved imaged is affected, but the current
image will remain unchanged.


ΓòÉΓòÉΓòÉ 2.2.5. SlideShow ΓòÉΓòÉΓòÉ

Slide Show is used to display a series of images; either a new image is
displayed after a certain amount of time or after a certain signal is given
(manual mode).  There are three ways to start a slide show.  One is to use the
Slide Show option.  Two is to drag a JView slide show file onto JView or to
open such a file with the Open File dialog.  Three is to drag and drop multiple
files onto JView.

The Drive listbox changes the current drive.

Quick Dir is explained elsewhere.

Directory is a listbox of the current directory.  Selecting an item in this
listbox will cause a change to that directory.

Note:  Selecting the current directory will deselect all the files highlighted
in the Files listbox.

The basic idea is to select a file that you want included in the display. You
can select a specific file by clicking on it in the File list box.  You may
select multiple files at one time.  A file is selected when it is highlighted.

Note:  If you double click on a file, it is immediately selected into the
Selected Files listbox.

If you have mistakenly highlighted a file, clicking on it again will
de-highlight it.  In addition to going after individual files in the Files
listbox, you may use any or all of the four buttons located below it.  *.gif
will highlight all files that have the .gif extension.  Similar for *.jpg while
*.* selects everything.  The Mask-> button will take whatever you have entered
in the entryfield to its right and use it for finding files.  You DO NOT use
wild card symbols here (*, ?).

Example:  Using .gif as the mask would highlight all files that have .gif in
them.  This would include
JView.gif
myfile.old.gif
1.gif.jpg
Using t as the mask would select any file with a t in it.

Once you have highlighted a file, hitting the Add-> button will select it into
the Selected Files listbox. The files listed there are the ones that will be
used in the actual slide show.

If you have decided that you don't want to include a file that is listed in the
Selected Files listbox, highlight it and use the <-Remove button to eliminate
it.

Note:  You can select multiple copies of the same file into the Selected Files
listbox.

The Start button will begin the slide show.

There are two additional buttons, Save and Load.  These are for storing and
retrieving a SlideShow file selection.  When a Slide Show file is saved, all
the files listed and the current Slide Show options are stored.  The default
extension for the file created is .sls but any file name can be used.  When
loading a file, all entries are placed into the selected listbox, including any
that are already there.  The Slide Show options are updated to those that were
in the file if any existed.  You can also start a Slide Show by selecting a
Slide Show file from the File Open Dialog or by dragging and dropping such a
file onto the JView icon or dragging and dropping multiple files onto JView.

Be aware that you can modify your selected options even when SlideShow is
running by selecting Options off the Main Menu.

Note:  When JView is minimized the SlideShow will pause after the next image
has been read in.

You can skip ahead to the next image in Timed mode by double clicking with the
left mouse button or hitting the N key.


ΓòÉΓòÉΓòÉ 2.2.5.1. SlideShow Options ΓòÉΓòÉΓòÉ

You can specify the Time interval between images being displayed.  This field
is ignored if you select manual mode.  The actual time interval is calculated
from the time the most recent image is displayed until the next image will
start to be read.  Because of time it take to read an image, the actual
interval between image displays may be quite different than that requested.

There are five different ways of having the image displayed.  The first three
are grouped with the ability to force them not to change their window size.
The fixed window size option does not affect the other two options.  Both Keep
True Aspect Ratio, Aspect Ratio can Distort, and Use Scroll Bars will resize up
to the size of the screen with each new file load unless Fixed Window Size is
specified. Keep True Aspect Ratio will always display the image in its correct
height vs width ratio.  If Fixed Window Size is selected, the image may be
padded with black space on the sides or top and bottom as needed. Aspect Ratio
can Distort will resize the window to the correct size if Fixed Window Size if
NOT selected.  Any subsequent resizes of the current image will force the image
to fit inside the window.  If Fixed Window Size is selected, the image will
always fit exactly into the window. Use Scroll Bars will use scroll bars to
control the display of the image.

The alternative two display options are size limited.  Auto Resize with
Constant Width will always keep the image at the current width of the window,
small images will expand appropriately while large ones will shrink.  The upper
left corner of the window is considered fixed, while the base is allowed to
float.  In this way the window will resize (as far down as the bottom of the
screen) to keep the aspect ratio correct. If the correct aspect ratio cannot be
achieved because the image would be too large, the image width will be padded.
Auto Resize with Constant Height is similar except the height of the window
will not change.  Again, the upper left corner is considered fixed and will not
be moved by JView.  The window will expand to the far right side of the screen
if needed.

The Loop option will cause the slide show to begin over again once all the
images have been cycled through.

Randomize files will cause the slide show images to appear in a random order,
otherwise they appear in the order listed in the Selected Files listbox shown
in the SlideShow dialog.

You can also specify whether you want the Slide Show to run at low priority.
This way your other applications will not be as affected during a file read.
See the discusstion about Low Priority Threads.

While not an option that can be specified here you do have the ability to use
the Float function once the Slide Show has started.  Access the command by
using the right mouse button.

Any of these options can be changed while the SlideShow is running.  Use the
right mouse button to bring up the appropriate menu.


ΓòÉΓòÉΓòÉ 2.2.6. Iconify & UnIconify ΓòÉΓòÉΓòÉ

This little puppy allows you to associate a miniature version of your image or
part of your image with the image file.  The icon is placed in the extended
attributes of the file and (depending on the resolution you have set, See
Options) adds about 5K to the file length.  When you open the drives
application, all the images that you have iconified will have little itsy-bitsy
versions of themselves displayed.  You decide at what resolution to store the
icon at. (As far as the drives application goes, the resolution that it will be
displayed at is a function of your screen resolution.  For instance, if you use
a 640 by 480 screen, icons are displayed at 32 by 32, while 1024x768 screens
get icons of 40 by 40.)

The icon information is also displayed when you use the "I" key on the open
file dialog.  This will expand the icon to display at 100 by 100.

Normally the entire image is used to make the icon, but if a cropping rectangle
is present only that part of the image will be used.

UnIconify will delete the icon information from the image file.


ΓòÉΓòÉΓòÉ <hidden> Quit ΓòÉΓòÉΓòÉ

What the heck are you thinking!  Quit - it quits the bleedin' program.  Did the
lack of an s confuse you.  Do you need a little icon that shows an exit sign!
I'm sorry, but were going to have to hold you back a semester.  Please have
your parents contact the principal's office to schedule a meeting for next
week.


ΓòÉΓòÉΓòÉ 2.3. Edit ΓòÉΓòÉΓòÉ

The commands listed under this heading will typically permanently change your
image, with the exception of Copying to the Clipboard (Copy...).


ΓòÉΓòÉΓòÉ 2.3.1. Copy and Paste ΓòÉΓòÉΓòÉ

The pathway to the copy and paste commands.


ΓòÉΓòÉΓòÉ 2.3.1.1. Copy... ΓòÉΓòÉΓòÉ

Copy to the clipboard.  The image will be copied to the system's clipboard.  If
your image is 8 bit, you will be asked whether you also want to copy the
image's palette. Some applications don't look for a palette and so the image
will get a distorted colormap if you tell JView to include the palette.  If you
don't copy in a palette, JView will convert the image to the system colors.

If a cropping region is present, only the image inside the cropping region and
under the the cropping lines gets copied.


ΓòÉΓòÉΓòÉ 2.3.1.2. Copy Special ΓòÉΓòÉΓòÉ

Copy to the clipboard using JView's own special format. If you are planning on
doing cut and paste between JView applications then use this method instead of
regular copy.  All colors and crop regions are preserved.


ΓòÉΓòÉΓòÉ 2.3.1.3. Paste ΓòÉΓòÉΓòÉ

Paste from the clipboard.  Whatever image JView is currently displaying will be
lost.


ΓòÉΓòÉΓòÉ 2.3.2. Resize ΓòÉΓòÉΓòÉ

Resizing is fairly self explanatory.  If you select one of the screen sizes,
the image will be either scaled up or down to exactly fill that screen size
without distortion (the image will not be padded, rather one dimension will fit
while the other will fit exactly or be left too small).

If you choose not to use a screen size, you can specify any Custom size. If you
check Keep aspect ratio true, amazingly enough the aspect ratio will remain
constant.

You have two choices for the method used to resize.  If you select Bilinear
Blending, approximations to a given pixel will be calculated by creation of a
grid mapping the old pixels to the new.  The effect is that the pixelization
effect that occurs when images are scaled up by large factors will not occur.
The image will become slightly blurry though.  It is also a time consuming
method.  If Bilinear Blending is not selected, then a quick method is used.

If you are running Biliner Blending you will have the chance to abort the
process by hitting the Cancel button.


ΓòÉΓòÉΓòÉ 2.3.3. Auto Crop ΓòÉΓòÉΓòÉ

In the options dialog you can specify a default crop value.  This value is used
by Auto Crop to do its cropping.  The logic of the auto crop is that you have
an image with borders on it that you wish removed.  If the borders are a single
color that is different than the colors used in your image, they can be easily
detected and deleted. The cropping value mentioned above comes into play
because the borders may not be uniform in color.  See Custom Crop for an
explanation of the value mentioned above.

There is no going back from Auto Crop, it is best used when you have a series
of images and can predict how the Auto Crop will affect them.


ΓòÉΓòÉΓòÉ 2.3.4. Crop ΓòÉΓòÉΓòÉ

Crop will delete all the areas that are outside the currently selected region.
You can use any crop style that you like, not just rectangles.  If you are
using a crop method besides rectangles, blank areas of the image will be filled
in with the default background color specified in Options.


ΓòÉΓòÉΓòÉ 2.3.5. Custom Crop ΓòÉΓòÉΓòÉ

Custom Crop performs the same function as Auto Cropping mentioned in the
previous section.  Unlike Auto Crop, you can specify the tolerance value and
also undo the results.

The tolerance value works based on the premiss that if a give row or column of
your image is mostly one color, then it is probably a border and should be
deleted. What is mostly?  That is where the tolerance comes in.  The tolerance
is a percentage of the pixels in question being uniform in color.  For
instance, if you have a tolerance value of 100, then you are saying that all
the pixels in question must be the same color. A value of 95 means that up to
5% of the pixels can be different from one another but at least 95% need to be
the same color.  If the pixels vary too much then the line is ignored.


ΓòÉΓòÉΓòÉ 2.4. Manipulations ΓòÉΓòÉΓòÉ

This menu command does nothing but bring down another pull down menu.  The
commands on that menu are used for changing or manipulating the current image.
Many have keyboard equivalents.  All these commands can be undone by using
another command or the same command twice, i.e. using rotate twice.


ΓòÉΓòÉΓòÉ 2.4.1. Flip ΓòÉΓòÉΓòÉ

Depending on the option selected, the current image is flipped (mirrored)
either vertically or horizontally.


ΓòÉΓòÉΓòÉ 2.4.2. Rotate ΓòÉΓòÉΓòÉ

Rotation is either clockwise or counterclockwise.  Rotation takes place in 90
degree increments. The easiest way to undo the affects of this command is to
pick up your monitor and rotate it 90 degrees in the opposite direction of the
way you started.  But you didn't come all this way just to read that, did you?


ΓòÉΓòÉΓòÉ 2.4.3. Zoom By Factor ΓòÉΓòÉΓòÉ

If you have chosen to display images by using scroll bars, you have the ability
to specify a zoom factor.  This affects the entire image.  100% would display
the image at its true size.


ΓòÉΓòÉΓòÉ 2.4.4. Zooming (Zoom In) ΓòÉΓòÉΓòÉ

Zooming allows the user to zoom in on a particular area of the image.  That
area is first selected by using the left mouse button and dragging out the
appropriate rectangle.  After a zoom has been performed, the menu option will
change to include a Zoom Out option.  The original image is unaffected by
zooming, as opposed to  Cropping .  You can keep on zooming in to your hearts
content, but Zooming Out goes all the way back to the original image.  You have
the ability to edit the zoomed image and then have those changes remain in
force once you have zoomed back out.


ΓòÉΓòÉΓòÉ 2.5. Options ΓòÉΓòÉΓòÉ

For the main Options Notebook you check or fill in the various selections as
you see fit and then select the action you would like with one of the four
buttons on the botton of the notebook.  Those buttons are:

o Apply (Options become active, but are not saved)
o Save (Options saved but not applied)
o Cancel (duh!)
o Help (duh, level 2)


ΓòÉΓòÉΓòÉ 2.5.1. Cropping ΓòÉΓòÉΓòÉ

These choices relate to the creation of cropping regions/paths and
auto-cropping.

Auto cropping is a method of having the computer decide when boundary areas
should be cropped.  The value here is the default value for use when
auto-cropping.

Background color refers to the color that will be used as fill when a
non-rectangular crop if performed.  The values entered represent the color in
RGB space where each value of red, green, and blue varies between 0 and 255
with all 0 being black and all 255 being white.  Double-click on the the
colorwell to edit the Background Color.


ΓòÉΓòÉΓòÉ 2.5.2. Directories Option ΓòÉΓòÉΓòÉ

If you useually like to save your images in the same directory, specify a drive
and directory here.  Each time you save a file, this directory will be the
default.  Leave blank to have this ignored.  The entry must be in the form of
drive and directory (c:\images).

Where would you like to start looking for images on startup?  Leave blank to
start in current directory.  The entry must be in the form of drive and
directory (c:\images).

For a detailed description of what Quick Directories do see Quick Dir.  In this
notebook page you type the desired directory into the entry field and then hit
the add button.  Similarly, select the directory you want to remove and hit the
del button to remove that selection.


ΓòÉΓòÉΓòÉ 2.5.3. Display Options (Window Sizing) ΓòÉΓòÉΓòÉ

These are options which apply to how the images are displayed.

Images can be shown so that the window is scaled to reflect the size of the
image each time it is loaded - this would mean making Fixed Window Size
unchecked.  With Fixed Window Size on, the window will not resize when a new
image is loaded.

Scale, keep true perspective means the width to height ratio remains constant.
The image gets padded with black if the image will not correctly fit into the
display window.  With Scale perspective can change  you can stretch the image
to fit the window.

Use Scroll Bars allows the use of scroll bars.  This is used in combination
with a zoom factor.  No scaling of the image takes place (other than the
specified zoom), the scroll bars are used if the image is larger than the
available window size.


ΓòÉΓòÉΓòÉ 2.5.4. Icon ΓòÉΓòÉΓòÉ

When you choose to iconfiy a file, the resolution you indicate here is used.
Higher resolutino will yeild better looking results but will use more storage
space.  To get an idea of how much space the icon information is using, do a
directory listing of the file in question and look at the size of the extended
attributes.  The majority of the extended attributes size will be due to the
icon.  The numbers you choose here refer to the resolution of the icon.


ΓòÉΓòÉΓòÉ 2.5.5. Memory Options ΓòÉΓòÉΓòÉ

The purpose of the memory limit option is to keep OS/2 from killing itself.
Image files are unique in that they can represent a large amount of information
in a small file by using compression techniques.  When you try and read a file
that calls for a display resolution of 10,000 by 10,000 in 24 bit mode, then
JView will need approximately 300 megabytes of memory to display it.  OS/2 will
try and allocate that memory by use of virtual memory and will most likely
crash your system and possibly take out a few files in the process (this is
less a problem under Warp than older versions of OS/2).  To prevent this, this
option checks requests for memory against a limit that you specify here.  If
the request is larger than the limit, you have the choice of aborting the file
read or continuing on.

Memory Check is two parts, a memory size field and a drive entry field. The
drive field should contain the drive (letter) that you currently have your
swapper.dat file residing.  (If you don't know then it is almost definitely
your primary hard drive, C).  The memory size is in bytes, and the default is
5,000,000 (5 Megabytes).  Change the value depending on your system
configuration. The value entered here will be the maximum size of memory to be
requested before the warning message is shown.

The other option here refers to whether you are willing to give up some
performance in exchange for less memory usage.  Without getting into the
gruesome details of how OS/2 stores image information, lets just say sometimes
there is a need to hold what amounts to two copies of your image data.  If you
select Low Memory Use then temporary files are used when needed instead of main
memory.  If you have truly huge amounts of memory on your system (16 megs or
better) then you might want to turn this off.  Most of us will leave it on.


ΓòÉΓòÉΓòÉ 2.5.6. Misc Options ΓòÉΓòÉΓòÉ

Check for OS/2 Image Readers on Startup  See the Optimizations Section for an
explanation of this function.

Show Image Info on Startup  Will show the image information dialog upon
startup.  See Image Infomation.

Show Load Progress shows the current status of file loading, basically a
percentage of image loaded.  Shown in the window title bar.  Some File formats
may not show this.  When dithering (quantizing) takes place, messages to that
affect will be displayed in the Title Bar.

Empty Clipboard Upon Exit When JView puts images into the clipboard (either
regular or special) they take up a lot of memory.  These images will remain in
the clipboard until some application removes them or OS/2 is shutdown.  This
option will empty the clipboard whenever JView is exited.

File Has Changed Warning Enabling this option will cause you to be notified
when you are about to cause all changes made to an image to be lost.  This
would happen if you resized the image and then tried to exit JView without
saving the file first.

Load Optional Dlls on Startup  See the Optimizations Section for an explanation
of this function.

No Title Bar On Startup will, surprisingly, either turn on or off the titlebar
when JView first starts up.

Serendipity This is a compatibility feature that causes JView to take on a
style of appearance that was found in its predecessor, JoeView.  It affects
aesthetics only and offers no performace gain or penalty.

Space Bar to Minimize  The space bar can be used as a hot key to minize JView -
a panic key if you will.  This might be undesireable to some, so this can be
turned on or off.  The space bar signal is used in both the main window and the
File Open Dialog.  It is not used in any other dialogs.

Bugs are a term used in the software industry to describe a type of
electrobio-organism that is found in the silicon chips that are present in many
of the components of your computer system.  These creatures, referred to in the
trade as tribbles, exist at the electron level and so can't be seen by the
human eye.  They subsist on the silica on which all electronic chips are made
and use the cycling of your computer system (turning on and off your computer)
to drive their reproductive cycles (when your computer is off they are
"hibernating" and when it is on they go into a reproductive mode - their
"summer" if you will).  It is for this reason that many professional computer
users leave their machines on all the time, without the cycling the tribbles
won't reproduce and so the amount of bugs is reduced.  As you know, bugs can
cause a program to crash; they do so by interfering with the electrons flowing
through the circuits of your computer.  A misdirected electron can collide with
another electron, which hits another and soon a cascade effect results wherein
your computer loses its ability to regulate the matter - antimatter flows and
so must abort in order to prevent damage.  The Bugs parameter here is an
indication of the amount of tribbles you believe are present in your system.
The Intel 486 line almost always has around 4000, and so the value of 4 should
be entered.  The higher performance processors, like the Pentium (Tm Intel),
contain many more transistors and so have correspondingly higher amounts of
bugs - 8000 is a good guess and so a value of 8 should be used.  JView uses
this information to try and anticipate the cascading affect mentioned above -
if the cascade is caught early enough it can be diffused by briefly going to
impulse power.  The details of the techniques used are presented in fascinating
detail in two seminal sources :

Kirk, J. T. and Spock, M. The Trouble With Tribbles, Federation Press, S.D.
1098274-5.

and (the following paper is in Gaelic, at the time of this help file's writing
no English translations were available)

McCoy, Dr. L., "Damma, Imadoc Tornota Programmer", Proceedings from Romulan
Acad. Conf., vol. 284, pp. 345-346, 2195.


ΓòÉΓòÉΓòÉ 2.5.7. Open Options ΓòÉΓòÉΓòÉ

The majority of these settings are described in Open Dialog.

The major option not covered there is the File Mask. This is the value that
will be loaded into the File Open Dialog File Mask upon startup.  Wild cards
are valid and you can separate groups by either a space or a ;, for example
*.bmp;*.gif;*.jpg or *.bmp *.gif *.jpg are both valid. There is a slight speed
penalty for each additional group.


ΓòÉΓòÉΓòÉ 2.5.8. Palette Options ΓòÉΓòÉΓòÉ

Three possible options are available regarding palettes.

First you can Overide System Colors  This allows JView to cream the system
colors when you are running in 8 bit (maximum of 256 colors) mode. These are
the colors used for dialogs, menu text, etc.  There are not that many of them,
roughly 20. The colors that the application can't place are mapped into the
closest ones the system will display. Usually the increase in image quality is
insignificant, but you might use this option if you are not going to look at
other applications while JView is running.

Next comes Aggressive on Palette. JView loves to fight for the colors it is
using.  If another application starts changing the palette this option will
cause JView to try and change the colors back every now and then.  If you are
working with another application it can get annoying having the colors flash
and the system will slow down somewhat.  This choice is relevant only if your
system is operating in 8 bit mode.

You can use a hot key (Alt A) to cycle this on or off.  When you do so JView
will beep a high tone when you turn it on, a low tone when it is off.

Even while Aggresive on Palette is off whenever you make JView the active
application the palette will become reset to the correct colors.

The above two options only affect how the image is displayed.  The actual
colors that make up the image in memory are not affected by these choices.
Display Using System Palette actually changes the colors that make up the
image.  The option will cause the image that is loaded to be diplayed using
only the colors that the system has in its default palette.  The method used to
convert to the system colors is a Floyd Steinberg error diffusion which yields
pretty good quality and has the advantage in that JView will not affect other
applications by reseting their palettes.  Also, mutlitple versions of JView can
be run and each one will not interfere with the others.  Since this will
actually change the colors of the image (not just the displayed colors) don't
use this to read and then save files if you want a true conversion.  As with
the above options, this option should only be used if your system is running in
8 bit mode.

You also have the option of choosing the maximum number of colors and image can
have. The choices are 256 (8 bit)  and 16.7 million (24 bit).  This is really a
function of what your video system is capable of handling. It is possible that
your display can only handle 15 or 16 bit.  Most 24 bit images will display
just fine with these video cards.  If you find a particular image shows
degradation, usually in the form of color bands, use color reduction to reduce
the image down to 15/16 bit.


ΓòÉΓòÉΓòÉ 2.5.9. PhotoCD Options ΓòÉΓòÉΓòÉ

If you have installed the library Dlls to read the Kodak PhotoCD file format,
you will find that various resolutions are supported.  Use the correct option
here to specify which resolution you wish the file to be loaded as.


ΓòÉΓòÉΓòÉ 2.5.10. Printer ΓòÉΓòÉΓòÉ

Choose the printer you wish to use as the default by double clicking on the
appropriate printer.


ΓòÉΓòÉΓòÉ 2.5.11. Dithering/Quantizing Options ΓòÉΓòÉΓòÉ

These are the different ways that a 24 bit image will be converted down to 8
bits so that it can be displayed when your system is only capable of 8 bit
video.  These do not apply to JPEG, which has its own options.  These are used
on Targas, PBM, PCX, and other formats that might contain 24 bit images.

o Gray  The fastest way.  Converts image to grayscale.  Good for previewing new
  pictures.

o Quick The fastest color way.  Not too bad but image degradations will occur.
  Image is mapped into a fixed 256 color palette.  Use this one for fast color
  previews.  The others (below) are better but much slower.

o Compromise Good compromise between speed and quality.  It doesn't do a great
  job if the image has 10's of thousands of colors.  You have the option of
  using error diffusion with this method, which will often improve the look of
  the image.

o Best  This implements Heckbert's Median Cut algorithm.  The best of the
  methods and also the slowest, especially when error diffusion is selected.
  Based on code by Jef Poskanzer (ppmquant.c - quantize colors).

Using the error diffusion option will usually produce noticeably better images.
This is more true for "real life" images than for cartoon types of images.

Quantizing (reducing down to 256 colors) isn't always needed and it is much
faster if quantizing can be avoided.  You have the ability to specify whether
the image data should be checked to see if it contains more than 256 colors.
If the images you will be looking at will mostly/always have more than 256
colors you should not do the checking as it will be a waste of time.  If the
images are almost always 256 colors or less then doing the check will speed up
file reads and assure that the images are not degraded by needlessly quantizing
them.


ΓòÉΓòÉΓòÉ 2.6. Selection Method ΓòÉΓòÉΓòÉ

The cropping tools (which are the same as selection tools) available here are
one of the most powerful features that you can use.  When you create an
outline, its use is not ony limited to cropping an image or copying to the
clipboard. Virtually every tool in JView is designed to function only on the
area that you have outlined.  For instance, if you were to select an area and
then choose the grayscale function, you would find that only the area selected
by the outline path would be affected.

You have several choices for the type of crop path to create.  Freehand is used
by holding down the left mouse button and then pressing the right button at
those points where you want a control points.  Holding both down has effect of
the path following the cursor exactly.  If you make a mistake and don't want
the last point selected, hit the escape key while keeping the left mouse button
depressed.  Alternatively you can use an ellipse or a rectangle for outlining.

The Crop Utility allows you to store a crop path for later use.  This is so you
can outline the head of a person, do some other manipulations and then bring
back the outline for reuse.


ΓòÉΓòÉΓòÉ 3. Other Information / Hints ΓòÉΓòÉΓòÉ

No, the hints aren't here, go in one more level.


ΓòÉΓòÉΓòÉ 3.1. Controls ΓòÉΓòÉΓòÉ

There are several custom controls (controls you are familiar with are buttons,
checkboxes, etc.) that JView uses.  There are described in detail in the
following subsections.


ΓòÉΓòÉΓòÉ 3.1.1. ColorWheel ΓòÉΓòÉΓòÉ

The colorwheel is a method of allowing you to interactively choose a color.
OS/2 uses one to allow you to choose palette information.  They all work in a
fairly similar fashion.

The JView colorwheel displays a possible color in a three part process. The
first part is the wheel itself.  The wheel shows a circle of colors that
represent the range of Hue and Saturation available in HSV colorspace when
intensity is equal to 100.  The color slider (the vertical rectangle of colors)
represents the color selected in the wheel section with intensities ranging
from 0 to 100.  The sample holder (the little circle of color beneath the
buttons) holds the actual color as created by the wheel and slider.  You many
drag the color out of the color sample (use the right mouse button) or use the
Cancel and OK buttons.

You have the ability to enter colors directly by specifiying their components
in a variety of color spaces by using the appropriate color space and values as
entered in the spin buttons.

You have the ability of finding a color anywhere on the screen by use of the
Find button.  The color selected will be the color of the pixel under the mouse
cursor when the right mouse button is pressed down. Note that you do not have
to click the right mouse button, a slow press will work.  When you use Find, a
magnified display of the area underneath the pointer is shown in the upper left
corner of the screen.  While the right mouse button is being used to signal
selection of a color, the left mouse button can still be used for its normal
purpose.

If your system is running with an 8 bit display a button labeled Refresh will
appear.  Because there may be a limit on the number of colors that can be
displayed at one time you may need to use Refresh to have the colorwheel's
colors not be distorted.


ΓòÉΓòÉΓòÉ 3.1.2. ColorWell ΓòÉΓòÉΓòÉ

This control holds the color that is of interest to the user.  The user may
drag a new color into the well, or they may double-click the left mouse button
to indicate that they wish to edit the color.  If an X appears across the
control, it indicates that no color is currently selected into the control.
When the control is disabled, it sinks a little.


ΓòÉΓòÉΓòÉ 3.1.3. Curve Control ΓòÉΓòÉΓòÉ

The curve control has many variations which are controlled by the dialog that
owns the curve control at the time in question.  For the user, the control is
manipulated by placing the pointer over the control point on the curve that is
of interest.  The left mouse button is then depressed and the user drags the
control point to the desired location.

The type of curve presented can be a function of between 2 and 10 points and
can be linear or spline based.  The curve can be changed by using the right
mouse button to bring up a popup menu which allows the user to select the
desired settings.  In addition, curves can be saved or loaded.

The curve is used as a way of visually mapping one series of points onto
another.


ΓòÉΓòÉΓòÉ 3.2. Drag and Drop ΓòÉΓòÉΓòÉ

JView supports the dragging and dropping of an image file or slideshow file
onto either the JView Icon or onto a running version of JView.  JView will not
accept drag and drop operations while a Slide Show is running or while a file
is currently being read.  If you drag and drop multiple files at one time, the
files will be loaded into a slide show and started with whatever defaults are
currently selected as slide show options.


ΓòÉΓòÉΓòÉ 3.3. Installation & Setup ΓòÉΓòÉΓòÉ

You should have seen this in the readme file included with your distribution of
JView.

We have used the philosophy that JView will impact your OS/2 system with as
little change as possible so that if you ever decide to  get rid of JView,
perish the thought, all you will need to do is delete the files in one
directory.

JView can be used as you got it without any system (config.sys) modifications.
For best results you should put the JView files in a directory that is included
in both your path statement and your libpath statement.  JView does sometimes
create temporary files and because of this it looks to see if you have either a
TMP or TEMP environental variable set in your config.sys.  Lots of application
use these so you probably have them defined.  If not, you can add one by
entering the line SET TMP=c:\os2\tmp (or whatever directory you want your temp
files stored in) in your config.sys file.  This keeps your system nice and
clean so that you don't get random files popping up all over the place.

The last installation option is aimed at people working in a network
environment.  You can put an environment variable called JVIEWINI that points
to a drive and directory where you want the JView.ini file to be. This is also
the place where the palette file (described below) and other JView (permanent)
files will be placed.  If this variable is not present in your config.sys,
these files get placed in the same directory as JView.exe is located.  The main
benefit of this option is that people running on a network can have one of
JView (exe, dlls,  and help) located on a common drive with each personal .ini
files on each person's machine.  In your config.sys this would look like SET
JVIEWINI=C:\IMAGES.

Thats about the only change to your system that you can make regarding JView.

When you run JView the first time, two files will be created.  The first is
JView.ini which contains information about your current configuration of JView.
The second file is JView.pal which contains the colors used in your default
system setup.  The pal file is important when you are converting images to use
the system colors on an 8 bit system.  When you run JView for the first time
(and create the pal file) you should have your system setup color-wise in the
way you will be using it.  This means that no other palette changing programs
should be running at the time.

Other files included with JView are the help files and several script and REXX
example files.  In addition, certain functions may create files. These should
always follow the standard of beginning with JVW or JView.


ΓòÉΓòÉΓòÉ 3.4. Key Help ΓòÉΓòÉΓòÉ

There are keyboard equivalents (hot keys) to most of the basic popup menu
commands.  Most are single character commands and will be shown on the menu
underlined.  This is a slight departure from most software where key combos
(like Cntrl + O) are the norm.  When a key combo is required, it is shown to
the right of the menu command.  These hot keys are only valid when the main
window is active.  They are:

A  Auto crop the image using Average parameter

Alt+A Toggle Aggessive Palette.  There will be a beep.

B Batch conversion.

C  Crop the image

Ctrl+C  Custom crop the image using Custom Dialog

F Toggle Floating Window on/off

Ctrl+F Flip image Vertically

Alt+F Flip image Horizontally

H  Help table of contents

I  Image information window

Ctrl+I Iconfy the file

K  This window

Ctrl+N  Opens next image in Open File Dialog's file listbox

Ctrl+O or O  Open a file

Alt+O  Options Dialog

P Print Image

Ctrl+P  Opens previous image in Open File Dialog's file listbox

R  Refresh image

Ctrl+R Rotate image Clockwise

Alt+R Rotate image CounterClockwise

S  Save a file

Ctrl+S  Slide Show Dialog

T Toggle Title Bar on and off

Z  Zoom in

Ctrl+Z  Zoom out

1 Zoom factor of 100% if using scroll bars for display.

2 Zoom factor of 200% if using scroll bars for display.

3 Zoom factor of 300% if using scroll bars for display.

4 Zoom factor of 400% if using scroll bars for display.

5 Zoom factor of 500% if using scroll bars for display.

Space Bar  Minimize JView (Has Option setting to disable this hot key).

Alt+F7  Move the window using arrow keys, works when Title Bar is off.

Alt+F4  Quit

F2 Brings up the main PopUp menu.

The Open File dialog has the following keyboard equivalents, they are active
only when the Open File dialog is active.  They are:

Ctrl+N Show next image.

Ctrl+P Show previous image.

Space Bar Minimize JView  (See space bar above).


ΓòÉΓòÉΓòÉ 3.5. Optimizations ΓòÉΓòÉΓòÉ

There are three ways that you can significantly change the speed and resource
use of JView.  What you need to think about is how you use this product.  That
will largely determine how you set these options.

First off, you have the ability to use image file readers/writers that ship
with OS/2 Warp's BonusPak.  If you have Light Tables installed on your system
then these readers are already present.  To install these readers from CD-ROM,
access the \MMVIEWER directory on your BonusPak CD.  Run the program MINSTALL
with the option /F:CONTROL.MMV.  If you have disks, run the program from the
diskette labelled IBM Multimedia Viewer.  (See page 3-5 of the document
labelled BonusPak that ships with Warp).  BTW, don't install them all, just the
ones you are interested in.

By installing these readers, you expand the range file formats that JView can
use.  Some of the formats available are the Kodak PhotoCD, Apple files, Atari
files, etc. Using these formats is slower than those that are built-in to
JView, but this method minimizes the duplication of code that would result if
JView had all of these built-in.  Further, as IBM releases new file formats,
JView will instantly be able to access them without you having to purchase an
updated version.

The downside to always loading these optional formats is that the startup time
for JView is increased and JView will use more system resources (read memory).
But just having them installed doesn't cause them to always be loaded.  Under
the Options dialog - the Misc section, you can specify whether to load these
readers on startup.  If you choose not to, a command will appear under the Misc
section of the main PopUp menu saying Load OS/2 Image Readers.  Selecting this
at any time while JView is running will add whatever readers are present.  So,
if you rarely use these optional formats, choose not to load them on startup.
If you find that you need to load an image stored in one of these formats, just
run the Load OS/2 Image Readers command and go ahead.

JView has been designed in a modular manner to allow you to pick and choose
what features you wish.  This has the side benefit of only loading those
functions you want or need. These functions are stored in DLLs (dynamic link
libraries) and their associated help files.  The downside to this method is
that the startup time for JView is increased.  If you use JView mostly to view
images and only sometimes want to use the optional features, you can specify
that JView not load the optional Dlls on startup.  You do this by checking the
appropriate box in the Options menu - under Misc, Load Optional Dlls on
Startup.  Now JView will starup much faster, but you have lost access to all
those features you may want at sometime.  Not to worry.  Just as happened
above, a new command will appear in the Misc section of the main PopUp menu.
This command is Load Add On Dlls. Running it will cause all the optional
function to become available.

To recap then, if most of the time you just use JView to view standard image
files (Bitmaps, GIFs, JPEGS) and little more, turn both Load Optional Dlls on
Startup and Check for OS/2 Image Readers on Startup off.

One last area for increasing performance involves the use of temporary files.
JView often needs to store large amounts of data but doesn't need to access
that data often.  Typically you would use temporary files to hold this
information instead of main memory.  The penalty for doing this is decreased
performance.  If you have lots of memory, you can choose not to use temporary
files by turning off Low Memory Use which is located in the Options dialog
under the Memory section.


ΓòÉΓòÉΓòÉ 3.6. Thread Priorities ΓòÉΓòÉΓòÉ

OS/2 has (for all practical purposes) 2 levels of thread priority, low(idle)
and regular.  There seems to be a limit on the number of low priority threads
that can be active at once.  Many applications (CPU meters, clocks, etc.) use
low priority threads.  Along comes JView and it wants to use one.  Well OS/2
will give JView a low priority thread, but OS/2 doesn't want to devote any CPU
cycles to that thread.  The net effect is that nothing happens as far as JView
processing is concerned.  Another possibility is that DOS Applications and
certain other OS/2 programs will cause OS/2 to not give any CPU time to low
priority threads.  If you have many applications running (or Dos programs) and
you try something with JView and nothing seems to happen, try regular priority
threads instead.  Most of the time with JView you can use a check box to
specify whether a command should occur at low or regular priority or you can
use a menu selection to alter the priority.  Some commands might start out at
low priority.  These commands can be upgraded to regular priority by using a
menu command.


ΓòÉΓòÉΓòÉ 3.7. Quick Dir ΓòÉΓòÉΓòÉ

An especially useful feature, the Quick Dir listbox is present in several
different dialogs.  It is only in the Options dialog the Quick Dir listbox can
be modified. Aside from modifying the Quick Dir listbox, the Options dialog is
not affected by it.  The format for an entry is to have a drive letter and full
path

For Example  c:\images\gif, there should not be any trailing slashes.  There is
no limit on the number of entries.

The basic use of the Quick Dir is to allow the user to quickly access
frequently used directories. So you put directories here that you often visit,
either for loading files or saving files.  Then, instead of having to change
drives and move through multiple directories you simply select the place you
want to go.


ΓòÉΓòÉΓòÉ 3.8. Viewing Strategies ΓòÉΓòÉΓòÉ

Images are displayed in several ways. Three ways that are always available are
: 1) a full size image where scroll bars appear if the image is larger than its
display window, 2) just a simple, correctly scaled image  and 3) an image that
starts out scaled, but if the window size changes the aspect ratio will change
so that the picture always fills up the entire window.  These types of display
can be modified somewhat by selecting the fixed window size attribute.  This
option will force JView to not resize the viewing window each time a new file
is loaded (whether by SlideShow or by File -> Open).  The user can resize the
window at any time.

The SlideShow offers two addition ways of displaying images.  See SlideShow for
more information.

The most important thing to remember when using JView is that the actual
resolution of the image (the width x height) is not always the same as that
which it is displayed with.  For example, let's say you are working on a system
that is limited to a display of 640 by 480 and you try and load an image that
is 2000 by 2000.  Assuming your are not using scroll bars, JView will resize
the image to fit the screen when it displays the image to you, but the data
representing the image will stay at 2000 by 2000.  Any operations
(manipulations) that you perform on the image will by done on the original
image, the 2000 by 2000 one.  Now, let's say you use the ReSize command to
reduce the image to 640 by 480.  From as far as you can tell, nothing will have
changed.  This is because the image size is still as big as the display can
handle.  In reality you have changed the image size and if you save the image
it will be different than the one you originally loaded.  The Image Information
option on the main menu will keep you apprised of the actual vs displayed
resolution of the current image.  When you save a file there is the option to
save at the currently displayed size, the above discussion is why that option
exists.


ΓòÉΓòÉΓòÉ 4. File Formats ΓòÉΓòÉΓòÉ

A variety of file formats are supported.  See each individual one for more
info.

You should be aware of some limitations when doing conversions between
different file formats or if you are constantly reading and saving the same
image over and over again (See JPEG).  When JView reads a file, no matter what
the original format, it is stored as an 8 bit image (256 colors max), unless
your have indicated that your system palette can handle 16 million colors (24
bit). This means that if you read in a JPEG, TARGA, Sun Raster, or PPM image
there exists the possibility that the original file is made up of more than 256
colors and so JView will reduce the colors down to 256.  So, if your goal is to
convert a 24 bit image to another 24 bit format, the intermediate stage will
cause a reduction to 8 bit if your system is setup for 8 bit graphics.  Because
of this there is a very good chance that your image will suffer a loss in
quality.

Eight bit formats will not suffer any degradation.


ΓòÉΓòÉΓòÉ 4.1. JPEG ΓòÉΓòÉΓòÉ

The JPEG reading and writing code is based on the following people's work:

The Independent JPEG Group's JPEG software
==========================================

This software is the work of Tom Lane, Philip Gladstone, Luis Ortiz, Jim
Boucher, Lee Crocker, George Phillips, Davide Rossi, Ge' Weijers, and other
members of the Independent JPEG Group.

LEGAL ISSUES
============

The authors make NO WARRANTY or representation, either express or implied,
with respect to this software, its quality, accuracy, merchantability, or
fitness for a particular purpose.  This software is provided "AS IS", and you,
its user, assume the entire risk as to its quality and accuracy.

This software is copyright (C) 1991, 1992, 1993, 1994, 1995, Thomas G. Lane.
All Rights Reserved except as specified below.

Permission for use of this software is granted only if the user accepts
full responsibility for any undesirable consequences; the authors accept
NO LIABILITY for damages of any kind.

Permission is NOT granted for the use of any IJG author's name or company name
in advertising or publicity relating to this software or products derived from
it.  This software may be referred to only as "the Independent JPEG Group's
software".

We specifically permit and encourage the use of this software as the basis of
commercial products, provided that all warranty or liability claims are
assumed by the product vendor.
==================

The Quality setting affectst the size of file that the JPEG save routine will
create.  It lets you trade off compressed file size against the quality of the
saved image: the higher the quality setting, the larger the JPEG file, and the
closer the output image will be to the original input.  Normally you want to
use the lowest quality setting (smallest file) that decompresses into something
visually indistinguishable from the original image.  For this purpose the
quality setting should be between 50 and 95; the default of 75 is often about
right.  If you see defects at quality 75, then go up 5 or 10 units at a time
until you are happy with the output image.  The optimal setting is an aesthetic
judgement that varies image to image. Quality values above about 95 are NOT
recommended for normal use; the compressed file size goes up dramatically for
hardly any gain in output image quality. In the other direction, quality values
below 50 will produce very small files of low image quality.  Settings around 5
to 10 might be useful in preparing an index of a large image library, for
example.  Try quality 2 (or so) for some amusing Cubist effects.  (Note:
quality values below about 25 generate 2-byte quantization tables, which are
considered optional in the JPEG standard. Some commercial JPEG programs may be
unable to decode the resulting file.)

Smooth Factor: Smooth the input image to eliminate dithering noise.  The value
selected, ranging from 1 to 100, indicates the strength of smoothing.  0 will
mean to not use smoothing and can be used instead of the check button.  The
Smooth option filters the currently displayed image to eliminate fine-scale
noise. A smoothing factor of 10 to 50 gets rid of dithering patterns in the
input file, resulting in a smaller JPEG file and a better-looking image.  Too
large a smoothing factor will visibly blur the image.

Optimization of entropy encoding parameters. Without this, default encoding
parameters are used. Optimize usually makes the JPEG file a little smaller, but
JView runs somewhat slower and needs much more memory.  Image quality and speed
of decompression are unaffected by optimize. It's also a win when you are using
low quality settings to make very small JPEG files; the percentage improvement
is often a lot more than it is on larger files.

The DCT method can be either Fast, Slow, or Float.  The DCT refers to the
transform used to create the actual JPEG data.  Ideally it is a floating point
process.  If your computer has its own floating point processor, you may get
superior performance by choosing Float (for floating point).  The other two
options refer to using integer methods to duplicate the floating point
calculations.  Fast, duh, is faster than the Slow method, but less accurate.
The DCT is used for both reading a writing of JPEGs.

When reading a JPEG on an 8 bit system, there are five mutually exclusive
option that deals with quantization of the colors (converting from a 24 to 8
bit image).  Your options are:

o Quick  The one pass color quantization.  The fastest of the color
  quantizings, but probably will result in a noticeably inferior image.  Good
  for a quick look.

o Slow  This implements Heckbert's Median Cut algorithm.  Quality in line with
  Best.  Very slow compared to the builtin JPEG quantizer.  For most JPEGs it
  will probably give only minor quality improvements. Make your own judgment.
  It is not part of the regular JPEG libraries.

o Best  Floyd-Steinberg dithering is used.  Based on ppmquant.c by Jef
  Poskanzer.

o BuiltIn  Uses the JPEG libraries built-in two pass quantizer.  This is the
  recommended choice.

o Gray  Hands down the fastest way to look at a JPEG.  Results in gray colors
  only, but good way to take a quick look.

When quantization takes place, you can optionally specify a dithering method.
Your choices are Floyd Steinberg (the recommended choice), Ordered and None.
Dithering is a method of introducing error into the image that actually make it
look better.  Seeing is believing.


ΓòÉΓòÉΓòÉ 4.2. Bitmaps ΓòÉΓòÉΓòÉ

The two important types of bitmaps supported are Windows and OS/2 style
bitmaps. JView should read any of these type of bitmaps (RLE and non-RLE) with
the following caveats:

o Black and White images that are stored by using modified Huffman encoding
  cannot be read.

o OS/2 allows the use of halftones and such.  JView does not read these but no
  one has ever seen one.

Bitmaps can be saved in either RLE on uncompressed format.  The RLE encoding
scheme is fairly brain dead and will actually increase the size of the file for
"real life" images with more than 16 colors.  JView does some comparing and
will minimize the file size to its best ability so you should only see slight
increases in file size but then again you may see a significant decrease.  You
pay your money and you takes your chances.


ΓòÉΓòÉΓòÉ 4.3. GIF ΓòÉΓòÉΓòÉ

Does em'.

JView will read both GIF87a and GIF89a formats but will write only GIF87a
format. If a mulit-image gif file is encountered you will have the option of
breaking the images apart and creating a sequence of OS/2 bitmaps from them or
just reading the first image.

"The Graphics Interchange Format(c) is the Copyright property of
CompuServe Incorporated.  GIF(sm) is a Service Mark property of
CompuServe Incorporated."


ΓòÉΓòÉΓòÉ 4.4. TARGA ΓòÉΓòÉΓòÉ

The code to read Targa images is based on tgatoppm.c by Jef Poskanzer.  This is
the copyright stuff from that file.

/* tgatoppm.c - read a TrueVision Targa file and write a portable pixmap
** Partially based on tga2rast, version 1.0, by Ian MacPhedran.
** Copyright (C) 1989 by Jef Poskanzer.
** Permission to use, copy, modify, and distribute this software and its
** documentation for any purpose and without fee is hereby granted, provided
** that the above copyright notice appear in all copies and that both that
** copyright notice and this permission notice appear in supporting
** documentation.  This software is provided "as is" without express or
** implied warranty.

JView does both RLE and non-RLE style files.


ΓòÉΓòÉΓòÉ 4.5. PBM ΓòÉΓòÉΓòÉ

JView uses the term PBM loosely, there are really three (or six) different
types of formats here.  They are:

             PGM - portable graymap file format

   The portable graymap format is a lowest common denominator grayscale file
   format.  The definition is as follows:

   - A "magic number" for identifying the file type.  A  pgm  file's  magic
    number is the two characters "P2".

   - Whitespace (blanks, TABs, CRs, LFs).

   - A width, formatted as ASCII characters in decimal.

   - Whitespace.

   - A height, again in ASCII decimal.

   - Whitespace.

   - The maximum gray value, again in ASCII decimal.

   - Whitespace.

   - Width * height gray values, each in ASCII decimal, between  0  and  the
    specified  maximum value, separated by whitespace, starting at the top-
    left corner of the graymap, proceding in normal English reading  order.
    A value of 0 means black, and the maximum value means white.

   - Characters from a "#" to the next end-of-line are ignored (comments).

   - No line should be longer than 70 characters.

   Here is an example of a small graymap in this format:
   P2
   # feep.pgm
   24 7
   15
   0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0
   0  3  3  3  3  0  0  7  7  7  7  0  0 11 11 11 11  0  0 15 15 15 15  0
   0  3  0  0  0  0  0  7  0  0  0  0  0 11  0  0  0  0  0 15  0  0 15  0
   0  3  3  3  0  0  0  7  7  7  0  0  0 11 11 11  0  0  0 15 15 15 15  0
   0  3  0  0  0  0  0  7  0  0  0  0  0 11  0  0  0  0  0 15  0  0  0  0
   0  3  0  0  0  0  0  7  7  7  7  0  0 11 11 11 11  0  0 15  0  0  0  0
   0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0


   There is also a variant on the format, the RAW style.
   This variant is different in the following ways:

   - The "magic number" is "P5" instead of "P2".

   - The gray values are stored as plain bytes, instead of ASCII decimal.

   - No whitespace is allowed in  the  grays  section,  and  only  a  single
    character  of  whitespace  (typically  a  newline) is allowed after the
    maxval.

   - The files are smaller and many times faster to read and write.

   Note that this raw format can only be used for maxvals less than or equal
   to 255.

          PBM - portable bitmap file format

   The portable bitmap format is a lowest common denominator monochrome file
   format.  It was originally designed to make it reasonable to mail bitmaps
   between different types of machines  using  the  typical  stupid  network
   mailers  we  have today.  Now it serves as the common language of a large
   family of bitmap conversion filters.  The definition is as follows:

   - A "magic number" for identifying the file type.  A  pbm  file's  magic
    number is the two characters "P1".

   - Whitespace (blanks, TABs, CRs, LFs).

   - A width, formatted as ASCII characters in decimal.

   - Whitespace.

   - A height, again in ASCII decimal.

   - Whitespace.

   - Width * height bits, each either '1' or '0', starting at  the  top-left
    corner of the bitmap, proceding in normal English reading order.

   - The character '1' means black, '0' means white.

   - Whitespace in the bits section is ignored.

   - Characters from a "#" to the next end-of-line are ignored (comments).

   - No line should be longer than 70 characters.

   Here is an example of a small bitmap in this format:
   P1
   # feep.pbm
   24 7
   0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
   0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 1 1 1 0
   0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 1 0
   0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 0 0 0 1 1 1 1 0
   0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0
   0 1 0 0 0 0 0 1 1 1 1 0 0 1 1 1 1 0 0 1 0 0 0 0
   0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0


   There is also a variant on the format, the RAW style.
   This variant is different in the following ways:

   - The "magic number" is "P4" instead of "P1".

   - The bits are stored eight per byte, high bit first low bit last.

   - No whitespace is allowed  in  the  bits  section,  and  only  a  single
    character  of  whitespace  (typically  a  newline) is allowed after the
    height.

   - The files are eight times smaller and many times  faster  to  read  and
    write.

              PPM - portable pixmap file format

   The portable pixmap format is a lowest  common  denominator  color  image
   file format.  The definition is as follows:

   - A "magic number" for identifying the file type.  A  ppm  file's  magic
    number is the two characters "P3".

   - Whitespace (blanks, TABs, CRs, LFs).

   - A width, formatted as ASCII characters in decimal.

   - Whitespace.

   - A height, again in ASCII decimal.

   - Whitespace.

   - The maximum color-component value, again in ASCII decimal.

   - Whitespace.

   - Width * height pixels, each three ASCII decimal values  between  0  and
    the  specified  maximum  value,  starting at the top-left corner of the
    pixmap, proceding in normal English reading order.  The  three  values
    for each pixel represent red, green, and blue, respectively; a value of
    0 means that color is off, and the maximum value means  that  color  is
    maxxed out.

   - Characters from a "#" to the next end-of-line are ignored (comments).

   - No line should be longer than 70 characters.

   Here is an example of a small pixmap in this format:
   P3
   # feep.ppm
   4 4
   15
   0  0  0   0  0  0   0  0  0  15  0 15
   0  0  0   0 15  7   0  0  0   0  0  0
   0  0  0   0  0  0   0 15  7   0  0  0
   15  0 15   0  0  0   0  0  0   0  0  0

   There is also a variant on the format, the RAW style.
   This variant is different in the following ways:

   - The "magic number" is "P6" instead of "P3".

   - The pixel values are stored as plain bytes, instead of ASCII decimal.

   - Whitespace is not allowed  in  the  pixels  area,  and  only  a  single
    character  of  whitespace  (typically  a  newline) is allowed after the
    maxval.

   - The files are smaller and many times faster to read and write.

   Note that this raw format can only be used for maxvals less than or equal
   to 255.

   The above three descriptions are very slightly altered versions of descriptions
   originally written and Copyrighted (C) 1989, 1991 by Jef Poskanzer.

So, if you need to input a file format that JView does not support, here is
your chance if you know the format of the data you already have.  Convert the
data into the appropriate ASCII format style above.  It is probably simplest
just to use the ppm format and let JView convert it down into the appropriate
number of colors.


ΓòÉΓòÉΓòÉ 4.6. X11 Bitmap ΓòÉΓòÉΓòÉ

The X11 format is for black and white images only.


ΓòÉΓòÉΓòÉ 4.7. Sun Raster ΓòÉΓòÉΓòÉ

Nothing too exciting to say here, it just does it.


ΓòÉΓòÉΓòÉ 4.8. PCX ΓòÉΓòÉΓòÉ

The code for reading and writing PCX files is based on work by Michael
Davidson.  There have been significant changes, including the ability to handle
24 bit images.  This should handle up to version 5 PCX.


ΓòÉΓòÉΓòÉ 4.9. TIFF ΓòÉΓòÉΓòÉ

The code for reading and writting TIFFs is based on code written by Sam
Leffler.  Here is his copyright notice.

/*
 * Copyright (c) 1991, 1992 Sam Leffler
 * Copyright (c) 1991, 1992 Silicon Graphics, Inc.
 *
 * Permission to use, copy, modify, distribute, and sell this software and
 * its documentation for any purpose is hereby granted without fee, provided
 * that (i) the above copyright notices and this permission notice appear in
 * all copies of the software and related documentation, and (ii) the names of
 * Sam Leffler and Silicon Graphics may not be used in any advertising or
 * publicity relating to the software without the specific, prior written
 * permission of Sam Leffler and Silicon Graphics.
 *
 * THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
 * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 *
 * IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
 * ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
 * OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 * WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
 * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
 * OF THIS SOFTWARE.
 */

When you save a TIFF file, there are five choices for the type of TIFF file to
stored.  The FAX choices will be reduced to black and white images first.

Understanding the TIFF specification is beyond the capabilites of most mortals
and we will not even begin to think about getting into it in detail.  If your
TIFF files are not displaying correctly, well tough tiff, it is beyond our
capabilities to go in and mess with the library supplied by Sam Leffler.


ΓòÉΓòÉΓòÉ 4.10. Utah RLE ΓòÉΓòÉΓòÉ

JView only reads Utah RLE files, it will not write them.


ΓòÉΓòÉΓòÉ 4.11. MetaFiles ΓòÉΓòÉΓòÉ

JView will only read MetaFiles, it will not write them.  Meta files are
actually a series of drawing commands and so you can imagine how big a file
would be if every command was to draw a single point at some color (well, WE
can imagine it at least).  JView will size the MetaFile to display onto the
screen and then create a raster version of it.  You cannot stop a MetaFile from
playing once it has started.

Since MetaFiles are played and not just displayed, JView will not perform batch
conversions on them.


ΓòÉΓòÉΓòÉ 4.12. Slide Show Files ΓòÉΓòÉΓòÉ

JView can store a selection of files for use in a Slide Show.  These typically
are given and extension of sls.  You can load these files using the Slide Show
Dialog or the regular File Open Dialog.  In addition, you can drag and drop
such a file onto JView to begin play.


ΓòÉΓòÉΓòÉ 4.13. Other File Formats ΓòÉΓòÉΓòÉ

JView has the ability to tap into file formats supported by Warp but not
actually built into JView.  See Additional Formats  for detailed info.


ΓòÉΓòÉΓòÉ 5. REXX Scripts ΓòÉΓòÉΓòÉ

One of the more powerful features of OS/2 is its command language, REXX.  JView
has the ability to run and interact with REXX scripts.  If a REXX script is
dragged onto JView, or a REXX file is opened, that file will be run by JView.
The REXX files should be designed to work with JView, to that end when such a
file is being run by JView several REXX commands become available so that the
REXX file can interact with JView.

When JView is running a REXX script, several commands are available.  They are
called just like any REXX command, with either

call JVWcommand("hello_there")
or
JVWcommand "hello_there"

Included with the distribution disk that JView comes on are two example REXX
files, example.cmd and povshow.cmd.  The files in conjunction with this help
section should provide you with enough information to write your own REXX
files.

The descriptions of the commands that follow will list the command names in
alphabetical order.  Beside each command will be a description of what the
command does and a listing of any required arguments.  When an argument is
described as a string, it means that alpahnumeric text is required - this is
contrasted with a number or integer.  "hello" is a string while 456 is an
integer. All numeric information must be integers, no decimals should be used.

o JVWCropImage.  This command is used to crop the current image.  There are
  four required arguments, all integers, and they specify the lower left corner
  and upper right corner of the cropping region.  In order they are the left
  most X position, the bottom most Y position, the right most X position, and
  the top most Y position.  An example is

    call JVWCropImage(10, 20, 400, 500)

  Assuming your image starts out being 1000 by 1000, this command would cause
  all pixels to the left of 10, below 20, right of 400 and above 500 to be
  discarded.


o JVWFlipImage.  This command will flip the image either horizontally or
  vertically depending on the supplied argument.  One argument is required and
  should be a string that is either "horizontal" or "vertical".  An example is

    call JVWFlipImage("vertical")

o JVWGetImageInfo  This command does not use any arguments.  It does return
  information in the form of a string that needs to be parsed for the
  individual values.  The parameters that make up the returned string are:
  image width, image height, image depth (8 or 24), number of unique colors
  (only significant for 8 bit images), window X position, window Y position,
  window width, window height, a string that is either "crop_on" or "crop_off"
  which informs whether a cropping (selection) region is active, and four
  integers that represent the lower left corner (x, y) and upper right corner
  (x, y) of the cropping rectangle if it is on.  An example of its use is

    rc = JVWGetImageInfo()
    PARSE VAR rc width height depth colors position_x position_y window_width window_height crop_status crop_left crop_bottom crop_right crop_top

o JVWOpenFile  This command causes a new image to be loaded.  It has one or two
  arguments, both strings.  The first argument is the name of the file to be
  loaded.  It should include a drive and full path.  The second argument is
  optional and signals whether a low priority thread should be used for the
  loading.  The second argument would be "low" if it is used.  Two examples

    call JVWOpenFile("c:\image\judy.jpg", "low") - a low priority read.
    call JVWOpenFile("c:\image\judy.jpg") - a regular priority read.

o JVWResizeImage.  This command resizes the image to the specified dimensions.
  Two arguments are required, both should be integers.  They are, in order, the
  new width and the new height.  An example is

    call JVWResizeImage(500, 1000)

  This would make the image 500 pixels wide and 1000 pixels high.


o JVWRotateImage.  This command will rotate the image 90 degrees in either the
  clockwise or counterclockwise direction.  One argument is required and should
  be a string that is either "clockwise" or "counterclockwise".  An example is

    call JVWRotateImage("clockwise")

o JVWSaveFile  This command is used to save the current image.  The command
  requires two arguments and has two optional argurments.  All arguments are
  strings.  The first argument is the file name.  It shoud include the drive
  and path. The next argument is the file type, it must be one of the
  following: "os2", "os2_rle", "windows", "windows_rle", "x11", "gif", "jpeg",
  "pbm_ascii", "pbm_raw", "pcx", "sun", "targa", "targa_rle", "tiff_none",
  "tiff_lzw", "tiff_pack", "tiff_fax_3", or "tiff_fax_4".  The next argument is
  optional and dictates the color depth of the saved image.  A value of "full"
  will not alter the color depth.  A value of "gray" will cause the image to be
  saved as grayscale, while "bw" will cause the image to become black and
  white.  The next argument is also optional and is either "low" or "high" and
  refers to the priority of the save thread.

  Note:  that if you wish to indicate a save priority that you have to also
  specify a color depth.  Examples would be

    call JVWSaveFile("c:\image\jane.jpg", "jpeg", "gray", "low)
    or
    call JVWSaveFile("c:\image\jane.bmp", "os2")
    but
    call JVWSaveFile("c:\image\tarzan.x11", "x11", "high")
    is invalid because a color depth was not specified.

o JVWSay  This is mostly useful as a debugging command to verify that the
  arguments you are passing are correct.  Any number of arguments are used,
  each one is displayed in a message box.  It can be used to tell the user that
  the script is complete, or for some other signal.  An example

    call JVWSay("hello")

o JVWSetOption  This is used to set a variety of options.  The number and type
  of arguments will vary depending on the option that is being set.  The
  possible arguments are:

   - "fixed_window" This will have two arguments.  The first will be the string
     "fixed_window" while the second will also be a string and be either "on"
     or "off".  Using these arguments will dictate whether a new image load
     will cause display resizing.  An example is

          call JVWSetOptions("fixed_window", "on")

   - "jpeg_quantize" This will have two arguments, both strings.  The first
     will be "jpeg_quantize" while the second will be either "quick" or "slow".
     This will set jpeg quantizing to use either the quick method or the 2 pass
     regular (slow) method.  An example is

          call JVWSetOptions("jpeg_quant", "quick")

   - "quantize" This will have two or three arguments, both strings.  The first
     is "quantize" while the second will be one of "quick", "slow",
     "compromise", "gray" or "error".  If the second argurment is "error" then
     a third argument is required and it is either "on" or "off".  The first
     four options refer to how quantizing (reducing an image from 24 bit to 8
     bit) takes place.  They are analogous to the methods that can be selected
     with the regular options dialog.  The "error" argument refers to error
     diffusion which can be set on or off.  Two examples

          call JVWSetOptions("quantize", "slow")
          or
          call JVWSetOptions("quantize", "error", "on")

o JVWSetSelectionMethod  Is used to choose the type of selection method
  (cropping method).  One argument is required and is one of "rectangle",
  "ellipse", or "freehand".  An example

    call JVWSetSelectionMethod("freehand")

o JVWSizeWindow  This command is used to resize and/or move the display window.
  The number of arguments can vary.  The arguments are:

   - "move" This will require three additional arguments, one string and two
     integers.  The string will be either "relative" or "absolute".  This
     dictates whether the move will be to an absolute position on the screen or
     relative to the current position.  The last two arguments, both integers,
     are the new position.  The horizontal value is first and the vertical
     value last.  An example is

          call JVWSizeWindow("move", "relative", 40, 50)
     This would cause the current window to move over 40 pixels and up 50.
   - "size"  Follows a similar format to "move".  This will resize the display
     window (just the display window, not the actual image data).  It requires
     three additional arguments, one string and two integers.  The string will
     be either "relative" or "absolute".  This dictates whether the size change
     is to absolute values or relative to current values. The third and fourth
     arguments are the width and hieght changes. An example is

          call JVWSizeWindow("size", "absolute", 100, 200)
     This would change the window's size to 100 pixels wide and 200 pixels
     high.


   - "invisible" Is used to change the visibility state of the window to
     hidden.  No other arguments are used with it.  An example is

          call JVWSizeWindow("invisible")

   - "visible" is used to change the visibility to state to visible.  No other
     arguments are used with it.  An example is

          call JVWSizeWindow("visible")


ΓòÉΓòÉΓòÉ 6. Copyright ΓòÉΓòÉΓòÉ

Crunch Products makes NO WARRANTY or representation, either expressed or
implied, with respect to JView, its quality, accuracy, merchantability, or
fitness for a particular purpose.  This software is provided "AS IS", and you,
its user, assume the entire risk as to its quality and accuracy.

This software is copyright (C) 1992, 1993, 1994, 1995 V. Joseph Burkley, Crunch
Products. All Rights Reserved except as specified below.

(1) Permission for use of this software is granted only if the user accepts
full responsibility for any undesirable consequences; Crunch Products accepts
NO LIABILITY for damages of any kind.

(2) Permission is NOT granted for the use of the authors' names or company name
in advertising or publicity relating to this software or products derived from
it.  Such permission may be granted on a case by case basis, contact Crunch
Products for further information.